home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / dash / README.source < prev   
Encoding:
Text File  |  2010-12-14  |  3.0 KB  |  85 lines
  1. Dash sources for Debian
  2. -----------------------
  3.  
  4. The dash Debian package sources are available through git, and
  5. through 'apt-get source dash'.  Getting the sources through git
  6. should be preferred:
  7.  
  8.  # apt-get install git  # if not yet done
  9.  
  10.  $ git clone http://smarden.org/git/dash.git/
  11.  $ cd dash
  12.  
  13. After cloning the repository, you have checked out the debian-sid
  14. branch, ready to be used by dpkg-buildpackage, e.g.
  15.  
  16.  $ dpkg-buildpackage -i -rfakeroot -uc -us
  17.  
  18. If you want to make changes in the ./debian/ subdirectory, this is the
  19. correct branch to work on.  After making changes, document them in
  20. debian/changelog, and commit through 'git add' and 'git commit', or 'git
  21. commit -a', or similar.  If you think the changes should be incorporated
  22. into the standard Debian package, create the patch[es] through 'git
  23. format-patch', and send them to the Debian Bug Tracking System, e.g.
  24.  
  25.  $ vi debian/rules
  26.  $ debchange -pi
  27.  $ git commit -a
  28.  $ git format-patch HEAD^
  29.  
  30.  
  31. If you want to make changes to the upstream dash sources, first checkout
  32. the release+patches branch
  33.  
  34.  $ git checkout -b release+patches origin/release+patches
  35.  
  36. The release+patches branch holds patches on top of the current release
  37. version that is packaged for Debian/unstable. The current release
  38. version is available in the release branch.  If you are interested, you
  39. can checkout this branch too
  40.  
  41.  $ git checkout -b release origin/release
  42.  
  43. When releasing a new Debian package based on a new upstream release, the
  44. release branch will be fastforwarded, and the release+patches branch is
  45. rewound and rebased onto the new HEAD of the release branch.  This is
  46. done by, e.g.
  47.  
  48.  $ git checkout release
  49.  $ git merge v0.5.5
  50.  $ git checkout release+patches
  51.  $ git rebase release
  52.  
  53. You generally don't need to do that, but beware that the release+patches
  54. branch is rewound occasionally.
  55.  
  56. After checking out the release+patches branch, make the desired changes
  57. to the upstream sources, and commit them.  To integrate the changes into
  58. the Debian package, extract these changes, and change to the debian-sid
  59. branch (Note: the file extension for the patches is '.diff', use 'git
  60. config --add format.suffix .diff' to make that the default)
  61.  
  62.  $ git format-patch release..release+patches
  63.  $ git checkout debian-sid
  64.  
  65. Now move the extracted patches into the debian/diff/ directory, add a
  66. meaningful message to debian/changelog, and commit the changes to the
  67. debian-sid branch
  68.  
  69.  $ mv ????-*.diff debian/diff/
  70.  $ git add debian/diff
  71.  $ debchange -pi
  72.  $ git add debian/changelog
  73.  $ git commit
  74.  
  75. Again, if you think the changes should be incorporated into the standard
  76. Debian package, create the patch[es] from the debian-sid branch through
  77. 'git format-patch', send them to the Debian Bug Tracking System.
  78.  
  79. There's a mailing list to coordinate work on the dash packages, if
  80. you're interested in helping please subscribe to the
  81. <debian-package-dash> mailing list by sending an email to
  82. <debian-package-dash-subscribe@list.smarden.org>.
  83.  
  84.  -- Gerrit Pape <pape@smarden.org>  Fri, 04 Jun 2010 00:22:12 +0000
  85.